home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / CD_TOOLS / JUKEBOX.ZIP;1 / JUKEBOX.DOC < prev    next >
Encoding:
Text File  |  1993-12-30  |  5.5 KB  |  119 lines
  1. CDROM Jukebox V1.0 (beta)
  2. written by Aaron Johnson
  3.  
  4. CDROM Jukebox is a program I wrote intended to play music CD's in a Multi-
  5. Disk CDRom Drive, however it will work with single disk players too.
  6.  
  7. This program is not intended to play CD's in the background, if that is what
  8. you want, then you should look for my other program called CDCTRL.
  9.  
  10. What this program does do is play CD's either once, continuously, or on
  11. shuffle play.  While it is playing a CD, it will display a PCX picture file
  12. of your choosing if you so desire.  Since it displays a picture, you need to
  13. have at least a standard VGA adapter and monitor to see it.  The pictures are
  14. displayed in mode 18h, which is 640x480x16.
  15.  
  16. USAGE: JUKEBOX once       - Plays all CD's from start to finish once.
  17.        JUKEBOX continuous - Plays all CD's from start to finish continuously.
  18.        JUKEBOX shuffle    - Shuffle plays all songs on all CD's once.
  19.        JUKEBOX eject      - Ejects CD.
  20.        JUKEBOX enter      - Lets to enter info for All CD's in drive.
  21.        JUKEBOX info       - Displays info on file for all CD's in drive.
  22.  
  23. While playing CD's, you may press any key and skip the song currently 
  24. playing, or press the ESC key to exit the program.
  25.  
  26. I will assume the first four options are self explanitory, and skip to the
  27. fifth one.
  28.  
  29. JUKEBOX enter
  30. -------------
  31. This allows you to enter the name, picture, and song titles for all CD's in
  32. the drive.  If a CD is already on file, you will be told so, and you may
  33. leave the current information alone or change it.  The picture file must
  34. be a 16 color PCX file, and I recommend you do not exceed 640 x 430.  If a
  35. picture is smaller than that, it will be centered.  If it is larger than 640
  36. pixels wide, I don't know what happens (I said this was a beta, didn't I?)
  37. and if it's taller than 430 pixels the CD name, song title, track info, and
  38. timer will probably not display properly.  The name, etc., start at line 432
  39. so 430 leaves 2 pixels for a top margin.  Also, it is drawn in color 15, and
  40. if you followed my advice about the picture height, the background color
  41. would be 0.  If you didn't, then the background would be the picture and if
  42. you design it so color 15 shows up ok against it then you should have no
  43. problem.  I was able to actually scan the CD album covers in 16-color gray
  44. scale and they looked quite nice.  If the program doesn't like your PCX file
  45. for some reason, or you have a GIF or other file that you want to use, I 
  46. suggest using VPIC by Bob Montgomery to view the picture, then tap "Z" to
  47. save it in the proper PCX format.  If you do not enter information for a CD,
  48. the program will display the supplied "JUKEBOX.PCX" file which I designed
  49. myself.  Obviously, no entry means no name or song title will be displayed.
  50.  
  51.  
  52. JUKEBOX info
  53. ------------
  54. This will display the information you entered for all CD's in the drive, or
  55. tell you that information for a CD is not on file.  That way if you don't
  56. remember if you entered a CD, you can check.  The display will pause between
  57. CD's so you can read it.
  58.  
  59. The datafile
  60. ------------
  61. The CD information is kept in a textfile called JUKEBOX.DAT.  If you wish,
  62. you may edit this file manually to change information instead of using the
  63. "JUKEBOX enter" command.  The format is as follows, with the actual data in
  64. quotes, and numeric values represented by the "#" symbol.  All numeric
  65. values MUST have all digits.  If you want a "1" and it says "##", use "01":
  66.  
  67. "##############"  A 14-digit CD Code.  Every entry starts with the CD code.  
  68.                   You can get this by typing "JUKEBOX info".  Because of
  69.                   the way the program scans the data file, you may have
  70.                   codes follow each other on separate lines.  We had to do
  71.                   this when we had two CD's that were the same, but one
  72.                   came from a store and one came from a club, and they had
  73.                   different codes.  Basically the program looks at every line
  74.                   until it finds the code for your CD, then it looks for the
  75.                   next pieces of information, discarding any lines that don't
  76.                   start with "name","file","track",or "end".
  77.  
  78. "name My Favorite CD"  The name of your CD
  79.  
  80. "file JUKEBOX.PCX"  The name of the PCX file associated with your CD.
  81.  
  82. "track ## This is my favorite song"  the song title for track ##.
  83.  
  84. "end" denotes the end of the information for this CD.
  85.  
  86.  
  87.  
  88. The "name","file", and "track ##" entries may be in any order.  If you have
  89. two of one entry like two "name" or two "track 02" entries, the last one will
  90. replace the previous one.
  91.  
  92. I have included a sample data file with this program so you may examine it
  93. if you have more questions.
  94.  
  95.  
  96.  
  97. Known Bugs:  
  98. -----------
  99. The only thing I've noticed is that the routines  that find the
  100. start and end of tracks may sometimes be a little off.  This is because the
  101. function that returns the starting and ending values uses a different scheme
  102. than the function that says "play from this point to this point", and I have
  103. no idea how to fix this at this time.
  104.  
  105. Future Enhancements that may or may not happen depending on how much people
  106. scream for them:
  107. ---------------------------------------------------------------------------
  108. 256 color picture display (GIF and PCX)
  109. Windows Version
  110.  
  111.  
  112. I can be reached through the following:
  113. Compu$erve: Aaron Johnson, 75470,3627
  114. Internet: ajohnson@ucrmath.ucr.edu
  115.       or: ajohnson@math.ucr.edu <-- they told me it was changing to this but
  116.                                     I don't think they ever made it work.
  117.  
  118.  
  119.